rev. 0.6 3/11 copyright ? 2011 by silicon laboratories an220 an220 usb d river c ustomization 1. introduction the information in this document and the associated software download is intend ed for use by developers creating usb products based on the cp210x usb-to- uart bridge controller device family or the c8051f32x, c8051f34x, c8051f38x, c8051t32x, and c8051t62x usb mcu device families a virtual com port driver is available fo r the cp210x family and is included with the purchase of a cp210x evaluation kit. additionally, drivers can be created using the usbxpress ? development kit for the cp210x, c8051f32x, c8051f34x, c8051f38x, c8051t32x, and c8051t62x device fa milies. this document describes the steps necessary to customize the windows ? device driver installation usin g the custom usb driver installation wizard. 2. customizing driver installations the driver installation is customizable by modifying certain sections of the hardware installation files (.inf). the strings contained in the .inf files affect what is displayed in the ?found new hardware wizard? dialogs, device manager, and the registry. the changes to the vid and pid in the driver in stallation should match the vid and pid contained in the eprom/flash of your product. see ?an144: cp21 xx device customization guide? for more information on changing the vid and pid for your product. note: any changes to the windows installation .inf files will require new windows hardware quality labs (whql) tests. 3. using the custom usb driver installation wizard the custom usb driver installation wizard generates a custom driver installation for distribution to end-users. this customized installation consists of modified .inf files, optional installation su pport files, and driver files for windows 2000/xp/server 2003/vista/windows 7. the optional installation executable provided can be used to copy driver files and register a device on a pc before or after the device has been connected. it will also add an entry in the add/remove programs listing. when the device is connect ed to the pc for the first time, the drivers will be insta lled with little interaction from the user. note: a customized installation does not contain certified drivers for windows xp/2003/vista/7. certification must be performed by microsoft for the new driver installation. an uncertified installation will not cause any other problems other than the warning message displayed by windows xp/2003/vista when installing uncertified drivers. uncertified drivers cannot be installed in windows 7 unless they are installed with a testing certificate or the i gnore serial signing option is enabled by pressing f8 on startup and selecting the corresponding option. to run the custom usb driver installation wizard, open customusbdriverwizard.exe , which is included in the an220sw.zip download. figure 1 shows the first screen of the custom usb dr iver installation wizard. choose the type of driver installation desired. for detailed instructions on creating a custom driver installation, see ?4. creating a custom driver?. this description goes through the process of customizing a cp210x driver. the process for creating a usbxpress? driver is the same as this description, only select ?usbxpress driver? on the starting screen of the wizard. figure 1. driver installation selection relevant devices this application note applies to the following devices: cp2101/2/3/4/5, c8051f320/1/6/7, c8051f340/1/2/3/4 /5/6/7/8/9/a/b/c/d, c8051f380/1/2/3/4/5/6/7, c8051t320/1/2/3/6/7 , c8051t620/1/2/3
an220 2 rev. 0.6 4. creating a custom driver this section describes how to create a custom driver. to begin, choose the type of installation to customize: ?virtual com port driver installation? or ?usbxpress installation?. differences between the two installations are noted, but a sample cp210x customization is shown in the figures. next, determine if an installation executable should be generated (see ?4.5. installation string options? and ?4.8. generation directory? for more information on the generated installer), and click next. 4.1. driver certification warning the first screen is the wa rning explaining that the generated driver in stallation will not be certified. (see figure 2.) click next to begin customizing your driver installation. figure 2. driver certification warning 4.2. operating system selection the first step in the customization utility (shown in figure 3) is to specify the operating system for which the custom driver is being generated. figure 3. operating system selection
an220 3 rev. 0.6 4.3. string and file name customization the next step in the cust omization utility (shown in figure 4) is to specify yo ur preferred strings and filenames. each field is de scribed in further detail below. 4.3.1. company name (l ong name for .inf file entries) the company name appears in the .inf file entries and has a maximum length of 255 characters. 4.3.2. company abbreviation (short name for .inf file entries) the abbreviation appears in the .inf file entries and has a maximum length of 31 characters. 4.3.3. file name for .inf this field allows for specif ication of a unique name for the .inf file. the maximum leng th of this string is eight characters. the genera ted file will be named xxxxxxxx.inf. figure 4. string and file customization 4.4. vid, pid, and device name customiza- tion the next step in the cust omization utility (shown in figure 5) allows multiple vi d/pid combinations in one driver. this entry is also where the device name, which appears in windows device manager, is specified. an example for windows 7 is shown in figure 7. 4.4.1. general device installation name this field is the general description of device installation. this will not app ear in device manager, but will show up during installati on if the user is prompted for a disk. 4.4.2. device list the device list allows multiple vid and pid combinations to be added to one driver. current devices can be edited by double-clicking an entry. figure 5. vid and pid customization to add a new entry, click the add button. a new dialog box (shown in figure 6) will appear with the following options. 4.4.3. device type this specifies which device is being customized. if the vcp driver for the cp2105 is being customized, two interface names will appear . otherwise, only one interface name will appear. 4.4.4. vid allows specification of a new vendor id (vid). 4.4.5. pid allows specification of a new product id (pid). 4.4.6. device name this string will be displa yed in device manager under the ports or usb tab. if the vcp driver for the cp2105 is being customized, two interface name s will appear.
an220 4 rev. 0.6 figure 6. add vid/pid/device name to installation figure 7. windows 7 device manager example if an installer is not being generated, then skip to ?4.9. option verification?. 4.5. installation string options the next step in the customization process is to specify options for the driver insta ller. the driver installer will allow for a device to be installed before or after a device has been connected to the pc. if this is run before a device is plugged in, drivers will already be registered for devices that belong to that installation. if a device is already plugged in, the inst aller will rescan the bus for any devices for that installation. this section covers adding the installer's strings and is shown in figure 8. the driver installer and its corresponding setup.ini file are explained in further detail in ?an335: usb driver installation utility?. 4.5.1. product name this is the string that identif ies the product installation in the add/remove programs lis ting. the string shows up as ? (driver removal)? for easy identification. 4.5.2. name for installation file this is will be the name of the installation executable and shows up as ?< installname>.exe?. figure 8. installation strings
an220 5 rev. 0.6 4.6. device options the next step in the cust omization utility (shown in figure 9) is to configure the serial enumeration and selective suspend options. 4.6.1. serial enumeration support this allows windows to ? enumerate? a device(s), such as serial mice or an external modem, connected to the cp210x . if your device always presents data to the pc (such as a gps device), t hen disable this to prevent false serial enumerations. 4.6.2. selective suspend support enabling this feature will put th e device to sleep if it has not been opened for a time longer than the specified timeout value. this is used to save power on the pc and is recommended unless your cp210x needs to be powered if a handle to the device is not opened. figure 9. device options 4.7. installation options specific options for the gui should now be specified. 4.7.1. display gui window during install check this option when using the generated installer as a stand-alone applic ation. the installer will display several gui windows during the installation process. uncheck this option to run the installer in quiet mode. when running in quiet mo de, no gui will be displayed. this is useful when using another application to launch this installer. 4.7.2. copy files to targ et directory during install: check this option if a copy of the drivers will be needed on the hard drive. this is useful when installing the drivers from a cd. uncheck this option if copies of the driver files are not needed on the hard drive. 4.7.3. target directory selects the hard drive locati on that will contain a copy of the driver files. the default location is c:\program files\silabs\mcu\cp210x for the vcp driver and c:\programfiles\s ilabs\mcu\usbxpress for the usbxpress driver. if the ?display gui window during installation? option is selected, this path can be changed during installation by clicking the browse button. however, if the ?display gui window during installation? option is not selected, then the default directory is always used unless a directory is specified through the command line. this option is ignored if the ?copy files to directory during setup? option is not selected. note: the target directory must be different for each product released. 4.7.4. display gui wi ndow during uninstall check this option when using the generated uninstaller as a stand-alone application. the uninstaller will display several gui windows during the uninstall process. uncheck this option if the uninstaller will be launched by another application. the uninstaller then runs in quiet mode. when running in qu iet mode, no gui will be displayed. 4.7.5. remove files from target directory during uninstall check this option if the files copied to the target directory should be removed upon uninstallation. this option is ignored if the ?copy files to directory during setup? option is not selected.
an220 6 rev. 0.6 figure 10. installation options 4.8. generation directory the next step in the custom ization utility is to specify where this custom driver?s installation files will be generated. the default directory for a vcp driver is c:\silabs\mcu\customc p210xdriverinstall , and the default for a usbxpress driver is c:\silabs\mcu\customusb xpressdriverinstall . however, a different directory can be selected or created. this step is shown in figure 11. note: this is not an actual installation of the drivers. this is simply a directory to output all installation files needed for the inst allation. these files can be added to a cd or oem installation for distribu- tion to the end-user. figure 11. generation directory 4.9. option verification the final step in the customizat ion utility is to review all of the selected options. if anything needs to be changed, the back button can be used to go back to previous pages to change items. once all options have been verified, press finish to create the customized driver files. this step is shown in figure 12. figure 12. option verification 5. customizing dri ver installations, macintosh os9 and osx if the vid or pid is changed from the default factory settings, contact silicon labora tories to obtain drivers that incorporate the new values. macintosh requires that the drivers be compiled with the values that will be used by the production cp210x device.
an220 rev. 0.6 7 d ocument c hange l ist revision 0.1 to revision 0.2 ? added cp2103 to relevant devices on page 1. revision 0.2 to revision 0.3 ? updated figures and customization description to reflect version 3.4 and later of the custom driver wizard. ? removed usbxpress specific customization description. version 3.4 and later contains the same process for customizing both vcp and usbxpress driver installations. ? removed preinstaller explanations and added descriptions on how the new driver installer is used. revision 0.3 to revision 0.4 ? updated diagrams and wording to reflect 4.1 and later versions of the custom driver wizard. ? updated to include documented support of c8051f34x devices. ? updated to reflect vista support. revision 0.4 to revision 0.5 ? added support for cp2104 and cp2105. ? added support for windows 7. ? updated all screen shots of the an220 software. ? updated explanations of an220 software. revision 0.5 to 0.6 ? added support for c8051f38x, c8051t32x, and c8051t62x devices. ? updated figures 1 through 12.
an220 8 rev. 0.6 c ontact i nformation silicon laboratories inc. 400 west cesar chavez austin, tx 78701 tel: 1+(512) 416-8500 fax: 1+(512) 416-9669 toll free: 1+(877) 444-3032 please visit the silicon labs technical support web page: https://www.silabs.com/support/pages/contacttechnicalsupport.aspx and register to submit a technical support request. silicon laboratories and silicon labs are trademarks of silicon laboratories inc. other products or brandnames mentioned herein are trademarks or registered trademarks of their respective holders. the information in this document is believed to be accurate in all respects at the time of publ ication but is subject to change without notice. silicon laboratories assumes no responsibility for errors and omissions, and disclaims responsibi lity for any consequences resu lting from the use of information included herein. ad ditionally, silicon laboratorie s assumes no responsibility for the functioning of und escribed features or parameters. silicon laboratories reserves the right to make changes without further notice . silicon laboratories makes no wa rranty, rep- resentation or guarantee regarding the suitability of its products for any particular purpose, nor does silicon laboratories as sume any liability arising out of the application or use of any product or circuit, and s pecifically disclaims any and all liability, including wi thout limitation conse- quential or incidental damages. silicon laborat ories products are not designed, intended, or authorized for use in applications intended to support or sustain life, or for any other application in which the failure of t he silicon laboratories product could create a s ituation where per- sonal injury or death may occur. should buyer purchase or us e silicon laboratories products for any such unintended or unauthor ized ap- plication, buyer shall indemnify and hold silicon laboratories harmles s against all claims and damages.
|
